xref: /haiku/docs/apps/mail/Public API/MIMEMultipartContainer.html (revision 1e36cfc2721ef13a187c6f7354dc9cbc485e89d3)
1*1e36cfc2SNiels Sascha Reedijk<HTML>
2*1e36cfc2SNiels Sascha Reedijk<HEAD>
3*1e36cfc2SNiels Sascha Reedijk   <TITLE>MIMEMultipartContainer</TITLE>
4*1e36cfc2SNiels Sascha Reedijk</HEAD>
5*1e36cfc2SNiels Sascha Reedijk<BODY BGCOLOR="#FFFFFF" LINK="#2222AA" BACKGROUND="../art/bodyBack.gif">
6*1e36cfc2SNiels Sascha Reedijk<P><A NAME=BCursor></A> <!--TOP LINKS--></P>
7*1e36cfc2SNiels Sascha Reedijk
8*1e36cfc2SNiels Sascha Reedijk<CENTER><TABLE BORDER=2 BGCOLOR="#FFDD88">
9*1e36cfc2SNiels Sascha Reedijk   <TR>
10*1e36cfc2SNiels Sascha Reedijk      <TD>
11*1e36cfc2SNiels Sascha Reedijk         <P><TABLE BGCOLOR="#550033" CELLPADDING=5>
12*1e36cfc2SNiels Sascha Reedijk            <TR>
13*1e36cfc2SNiels Sascha Reedijk               <TD>
14*1e36cfc2SNiels Sascha Reedijk                  <P><A HREF="../index.html"><FONT FACE="HELVETICA" COLOR="#FFFFFF"><B>Mail
15*1e36cfc2SNiels Sascha Reedijk                  Kit 2 Root</B></FONT></A></P>
16*1e36cfc2SNiels Sascha Reedijk               </TD>
17*1e36cfc2SNiels Sascha Reedijk               <TD>
18*1e36cfc2SNiels Sascha Reedijk                  <P><A HREF="index.html"><FONT FACE="HELVETICA" COLOR="#FFFFFF"><B>The
19*1e36cfc2SNiels Sascha Reedijk                  Public API</B></FONT></A></P>
20*1e36cfc2SNiels Sascha Reedijk               </TD>
21*1e36cfc2SNiels Sascha Reedijk            </TR>
22*1e36cfc2SNiels Sascha Reedijk         </TABLE>
23*1e36cfc2SNiels Sascha Reedijk         </P>
24*1e36cfc2SNiels Sascha Reedijk      </TD>
25*1e36cfc2SNiels Sascha Reedijk   </TR>
26*1e36cfc2SNiels Sascha Reedijk</TABLE>
27*1e36cfc2SNiels Sascha Reedijk
28*1e36cfc2SNiels Sascha Reedijk<HR NOSHADE>
29*1e36cfc2SNiels Sascha Reedijk
30*1e36cfc2SNiels Sascha Reedijk</CENTER>
31*1e36cfc2SNiels Sascha Reedijk
32*1e36cfc2SNiels Sascha Reedijk<P><!--TOP LINKS--></P>
33*1e36cfc2SNiels Sascha Reedijk
34*1e36cfc2SNiels Sascha Reedijk<H1><FONT SIZE="+4">MIMEMultipartContainer</FONT></H1>
35*1e36cfc2SNiels Sascha Reedijk
36*1e36cfc2SNiels Sascha Reedijk<BLOCKQUOTE><FONT FACE="helvetica"><B>Derived
37*1e36cfc2SNiels Sascha Reedijk   from:</B></FONT>&nbsp;<A HREF="MailComponent.html">MailComponent</A><BR>
38*1e36cfc2SNiels Sascha Reedijk   <FONT FACE="helvetica"><B>Declared in:</B></FONT>&nbsp;
39*1e36cfc2SNiels Sascha Reedijk   include/public/MailContainer.h<BR>
40*1e36cfc2SNiels Sascha Reedijk   <FONT FACE="helvetica"><B>Library:</B></FONT>&nbsp;libmail.so<BR>
41*1e36cfc2SNiels Sascha Reedijk
42*1e36cfc2SNiels Sascha Reedijk   <P><BR>
43*1e36cfc2SNiels Sascha Reedijk   </P>
44*1e36cfc2SNiels Sascha Reedijk
45*1e36cfc2SNiels Sascha Reedijk   <P>MIMEMultipartContainer uses the RFC 2046 multipart specification to allow you to place
46*1e36cfc2SNiels Sascha Reedijk   multiple components in a single message. Mostly useful for attachments and things.</P></BLOCKQUOTE>
47*1e36cfc2SNiels Sascha Reedijk
48*1e36cfc2SNiels Sascha Reedijk<P>
49*1e36cfc2SNiels Sascha Reedijk
50*1e36cfc2SNiels Sascha Reedijk<HR NOSHADE>
51*1e36cfc2SNiels Sascha Reedijk
52*1e36cfc2SNiels Sascha Reedijk</P>
53*1e36cfc2SNiels Sascha Reedijk
54*1e36cfc2SNiels Sascha Reedijk<H2><FONT SIZE="+3" COLOR="#430000">C</FONT><FONT COLOR="#430000">onstructor
55*1e36cfc2SNiels Sascha Reedijkand
56*1e36cfc2SNiels Sascha Reedijk</FONT><FONT SIZE="+3" COLOR="#430000">D</FONT><FONT COLOR="#430000">estructor</FONT></H2>
57*1e36cfc2SNiels Sascha Reedijk
58*1e36cfc2SNiels Sascha Reedijk<P>
59*1e36cfc2SNiels Sascha Reedijk
60*1e36cfc2SNiels Sascha Reedijk<HR>
61*1e36cfc2SNiels Sascha Reedijk
62*1e36cfc2SNiels Sascha Reedijk<A NAME=MIMEMultipartContainer></A><TABLE>
63*1e36cfc2SNiels Sascha Reedijk   <TR>
64*1e36cfc2SNiels Sascha Reedijk      <TD>
65*1e36cfc2SNiels Sascha Reedijk         <P></P>
66*1e36cfc2SNiels Sascha Reedijk      </TD>
67*1e36cfc2SNiels Sascha Reedijk      <TD>
68*1e36cfc2SNiels Sascha Reedijk         <P><FONT SIZE="+2">MIMEMultipartContainer()
69*1e36cfc2SNiels Sascha Reedijk         </FONT></P>
70*1e36cfc2SNiels Sascha Reedijk      </TD>
71*1e36cfc2SNiels Sascha Reedijk   </TR>
72*1e36cfc2SNiels Sascha Reedijk</TABLE>
73*1e36cfc2SNiels Sascha Reedijk</P>
74*1e36cfc2SNiels Sascha Reedijk
75*1e36cfc2SNiels Sascha Reedijk<P>&nbsp;</P>
76*1e36cfc2SNiels Sascha Reedijk
77*1e36cfc2SNiels Sascha Reedijk<BLOCKQUOTE><TABLE BORDER=2 BGCOLOR="#550033" WIDTH=1000>
78*1e36cfc2SNiels Sascha Reedijk      <TR>
79*1e36cfc2SNiels Sascha Reedijk         <TD>
80*1e36cfc2SNiels Sascha Reedijk            <P><TABLE BORDER=1 BGCOLOR="#FFFFFF" CELLPADDING=8 WIDTH=1000>
81*1e36cfc2SNiels Sascha Reedijk               <TR>
82*1e36cfc2SNiels Sascha Reedijk                  <TD>
83*1e36cfc2SNiels Sascha Reedijk                     <FONT SIZE="+1"><B><TT>MIMEMultipartContainer(</TT></B></FONT>
84*1e36cfc2SNiels Sascha Reedijk                     const char *<FONT FACE="HELVETICA" COLOR="#991122"><I>boundary</I></FONT> = <B>NULL</B>,
85*1e36cfc2SNiels Sascha Reedijk                     const char *<FONT FACE="HELVETICA" COLOR="#991122"><I>this_is_an_MIME_message_text</I></FONT> = <B>NULL</B>
86*1e36cfc2SNiels Sascha Reedijk                     <FONT SIZE="+1"><B><TT>)</TT></B></FONT></P>
87*1e36cfc2SNiels Sascha Reedijk                  </TD>
88*1e36cfc2SNiels Sascha Reedijk               </TR>
89*1e36cfc2SNiels Sascha Reedijk            </TABLE>
90*1e36cfc2SNiels Sascha Reedijk            </P>
91*1e36cfc2SNiels Sascha Reedijk         </TD>
92*1e36cfc2SNiels Sascha Reedijk      </TR>
93*1e36cfc2SNiels Sascha Reedijk   </TABLE>
94*1e36cfc2SNiels Sascha Reedijk
95*1e36cfc2SNiels Sascha Reedijk   <P>Initializes the <B>MIMEMultipartContainer</B>. Sets the boundary between parts to <FONT FACE="HELVETICA" COLOR="#991122"><I>boundary</I></FONT>.
96*1e36cfc2SNiels Sascha Reedijk   Note that <FONT FACE="HELVETICA" COLOR="#991122"><I>boundary</I></FONT> can be an arbitrary text string but <B>must</B> contain only US-ASCII
97*1e36cfc2SNiels Sascha Reedijk   characters and be unique to this particular MIMEMultipartContainer. It does not have to be globally unique, however. <FONT FACE="HELVETICA" COLOR="#991122"><I>boundary</I></FONT> must be specified,
98*1e36cfc2SNiels Sascha Reedijk   either here or through <A HREF="#SetBoundary">SetBoundary()</A>. Also, sets the warning text about &quot;This is an MIME message...&quot; to <FONT FACE="HELVETICA" COLOR="#991122"><I>this_is_an_MIME_message_text</I></FONT>,
99*1e36cfc2SNiels Sascha Reedijk   which need not be specified at all.</P>
100*1e36cfc2SNiels Sascha Reedijk
101*1e36cfc2SNiels Sascha Reedijk   </BLOCKQUOTE>
102*1e36cfc2SNiels Sascha Reedijk
103*1e36cfc2SNiels Sascha Reedijk<P>
104*1e36cfc2SNiels Sascha Reedijk
105*1e36cfc2SNiels Sascha Reedijk<HR>
106*1e36cfc2SNiels Sascha Reedijk
107*1e36cfc2SNiels Sascha Reedijk<A NAME="~MIMEMultipartContainer"></A><TABLE>
108*1e36cfc2SNiels Sascha Reedijk   <TR>
109*1e36cfc2SNiels Sascha Reedijk      <TD>
110*1e36cfc2SNiels Sascha Reedijk         <P></P>
111*1e36cfc2SNiels Sascha Reedijk      </TD>
112*1e36cfc2SNiels Sascha Reedijk      <TD>
113*1e36cfc2SNiels Sascha Reedijk         <P><FONT SIZE="+2">~MIMEMultipartContainer()
114*1e36cfc2SNiels Sascha Reedijk         </FONT></P>
115*1e36cfc2SNiels Sascha Reedijk      </TD>
116*1e36cfc2SNiels Sascha Reedijk   </TR>
117*1e36cfc2SNiels Sascha Reedijk</TABLE>
118*1e36cfc2SNiels Sascha Reedijk</P>
119*1e36cfc2SNiels Sascha Reedijk
120*1e36cfc2SNiels Sascha Reedijk<P>&nbsp;</P>
121*1e36cfc2SNiels Sascha Reedijk
122*1e36cfc2SNiels Sascha Reedijk<BLOCKQUOTE><TABLE BORDER=2 BGCOLOR="#550033" WIDTH=1000>
123*1e36cfc2SNiels Sascha Reedijk      <TR>
124*1e36cfc2SNiels Sascha Reedijk         <TD>
125*1e36cfc2SNiels Sascha Reedijk            <P><TABLE BORDER=1 BGCOLOR="#FFFFFF" CELLPADDING=8 WIDTH=1000>
126*1e36cfc2SNiels Sascha Reedijk               <TR>
127*1e36cfc2SNiels Sascha Reedijk                  <TD>
128*1e36cfc2SNiels Sascha Reedijk                     <P>virtual
129*1e36cfc2SNiels Sascha Reedijk                     <FONT SIZE="+1"><B><TT>~MIMEMultipartContainer()</TT></B></FONT></P>
130*1e36cfc2SNiels Sascha Reedijk                  </TD>
131*1e36cfc2SNiels Sascha Reedijk               </TR>
132*1e36cfc2SNiels Sascha Reedijk            </TABLE>
133*1e36cfc2SNiels Sascha Reedijk            </P>
134*1e36cfc2SNiels Sascha Reedijk         </TD>
135*1e36cfc2SNiels Sascha Reedijk      </TR>
136*1e36cfc2SNiels Sascha Reedijk   </TABLE>
137*1e36cfc2SNiels Sascha Reedijk
138*1e36cfc2SNiels Sascha Reedijk   <P>Destroys the <B>MIMEMultipartContainer</B>. Note that this deletes all components which may have been added to
139*1e36cfc2SNiels Sascha Reedijk   this object. The ownership of all components is assumed by <B>MIMEMultipartContainer</B> when they are added.</P></BLOCKQUOTE>
140*1e36cfc2SNiels Sascha Reedijk
141*1e36cfc2SNiels Sascha Reedijk<P>
142*1e36cfc2SNiels Sascha Reedijk
143*1e36cfc2SNiels Sascha Reedijk<HR NOSHADE>
144*1e36cfc2SNiels Sascha Reedijk
145*1e36cfc2SNiels Sascha Reedijk</P>
146*1e36cfc2SNiels Sascha Reedijk
147*1e36cfc2SNiels Sascha Reedijk<H2><FONT SIZE="+3" COLOR="#430000">M</FONT><FONT COLOR="#430000">ember
148*1e36cfc2SNiels Sascha Reedijk</FONT><FONT SIZE="+3" COLOR="#430000">F</FONT><FONT COLOR="#430000">unctions</FONT></H2>
149*1e36cfc2SNiels Sascha Reedijk
150*1e36cfc2SNiels Sascha Reedijk<P>
151*1e36cfc2SNiels Sascha Reedijk
152*1e36cfc2SNiels Sascha Reedijk<HR>
153*1e36cfc2SNiels Sascha Reedijk
154*1e36cfc2SNiels Sascha Reedijk<A NAME=GetDecodedData></A><TABLE>
155*1e36cfc2SNiels Sascha Reedijk   <TR>
156*1e36cfc2SNiels Sascha Reedijk      <TD>
157*1e36cfc2SNiels Sascha Reedijk         <P></P>
158*1e36cfc2SNiels Sascha Reedijk      </TD>
159*1e36cfc2SNiels Sascha Reedijk      <TD>
160*1e36cfc2SNiels Sascha Reedijk         <P><FONT SIZE="+2">GetDecodedData () </FONT></P>
161*1e36cfc2SNiels Sascha Reedijk      </TD>
162*1e36cfc2SNiels Sascha Reedijk   </TR>
163*1e36cfc2SNiels Sascha Reedijk</TABLE>
164*1e36cfc2SNiels Sascha Reedijk</P>
165*1e36cfc2SNiels Sascha Reedijk
166*1e36cfc2SNiels Sascha Reedijk<P>&nbsp;</P>
167*1e36cfc2SNiels Sascha Reedijk
168*1e36cfc2SNiels Sascha Reedijk<BLOCKQUOTE><TABLE BORDER=2 BGCOLOR="#550033" WIDTH=1000>
169*1e36cfc2SNiels Sascha Reedijk      <TR>
170*1e36cfc2SNiels Sascha Reedijk         <TD>
171*1e36cfc2SNiels Sascha Reedijk            <P><TABLE BORDER=1 BGCOLOR="#FFFFFF" CELLPADDING=8 WIDTH=1000>
172*1e36cfc2SNiels Sascha Reedijk               <TR>
173*1e36cfc2SNiels Sascha Reedijk                  <TD>
174*1e36cfc2SNiels Sascha Reedijk                     <P>virtual status_t
175*1e36cfc2SNiels Sascha Reedijk                     <FONT SIZE="+1"><B><TT>GetDecodedData(</TT></B></FONT>BPositionIO
176*1e36cfc2SNiels Sascha Reedijk                     *<FONT FACE="HELVETICA" COLOR="#991122"><I>data</I></FONT><FONT SIZE="+1"><B><TT>)</TT></B></FONT></P>
177*1e36cfc2SNiels Sascha Reedijk                  </TD>
178*1e36cfc2SNiels Sascha Reedijk               </TR>
179*1e36cfc2SNiels Sascha Reedijk            </TABLE>
180*1e36cfc2SNiels Sascha Reedijk            </P>
181*1e36cfc2SNiels Sascha Reedijk         </TD>
182*1e36cfc2SNiels Sascha Reedijk      </TR>
183*1e36cfc2SNiels Sascha Reedijk   </TABLE>
184*1e36cfc2SNiels Sascha Reedijk
185*1e36cfc2SNiels Sascha Reedijk   <P>Returns an error. MIMEMultipartComponents don't have data of their own..</P>
186*1e36cfc2SNiels Sascha Reedijk
187*1e36cfc2SNiels Sascha Reedijk   <P><B>Return Value:</B></P>
188*1e36cfc2SNiels Sascha Reedijk
189*1e36cfc2SNiels Sascha Reedijk   <BLOCKQUOTE>- <B>B_BAD_TYPE</B> This operation is guranteed to fail.</BLOCKQUOTE></BLOCKQUOTE>
190*1e36cfc2SNiels Sascha Reedijk
191*1e36cfc2SNiels Sascha Reedijk<P>
192*1e36cfc2SNiels Sascha Reedijk
193*1e36cfc2SNiels Sascha Reedijk<HR>
194*1e36cfc2SNiels Sascha Reedijk
195*1e36cfc2SNiels Sascha Reedijk<A NAME=SetDecodedData></A><TABLE>
196*1e36cfc2SNiels Sascha Reedijk   <TR>
197*1e36cfc2SNiels Sascha Reedijk      <TD>
198*1e36cfc2SNiels Sascha Reedijk         <P></P>
199*1e36cfc2SNiels Sascha Reedijk      </TD>
200*1e36cfc2SNiels Sascha Reedijk      <TD>
201*1e36cfc2SNiels Sascha Reedijk         <P><FONT SIZE="+2">SetDecodedData () </FONT></P>
202*1e36cfc2SNiels Sascha Reedijk      </TD>
203*1e36cfc2SNiels Sascha Reedijk   </TR>
204*1e36cfc2SNiels Sascha Reedijk</TABLE>
205*1e36cfc2SNiels Sascha Reedijk</P>
206*1e36cfc2SNiels Sascha Reedijk
207*1e36cfc2SNiels Sascha Reedijk<P>&nbsp;</P>
208*1e36cfc2SNiels Sascha Reedijk
209*1e36cfc2SNiels Sascha Reedijk<BLOCKQUOTE><TABLE BORDER=2 BGCOLOR="#550033" WIDTH=1000>
210*1e36cfc2SNiels Sascha Reedijk      <TR>
211*1e36cfc2SNiels Sascha Reedijk         <TD>
212*1e36cfc2SNiels Sascha Reedijk            <P><TABLE BORDER=1 BGCOLOR="#FFFFFF" CELLPADDING=8 WIDTH=1000>
213*1e36cfc2SNiels Sascha Reedijk               <TR>
214*1e36cfc2SNiels Sascha Reedijk                  <TD>
215*1e36cfc2SNiels Sascha Reedijk                     <P>virtual status_t
216*1e36cfc2SNiels Sascha Reedijk                     <FONT SIZE="+1"><B><TT>SetDecodedData(</TT></B></FONT>BPositionIO
217*1e36cfc2SNiels Sascha Reedijk                     *<FONT FACE="HELVETICA" COLOR="#991122"><I>data</I></FONT><FONT SIZE="+1"><B><TT>)</TT></B></FONT></P>
218*1e36cfc2SNiels Sascha Reedijk                  </TD>
219*1e36cfc2SNiels Sascha Reedijk               </TR>
220*1e36cfc2SNiels Sascha Reedijk            </TABLE>
221*1e36cfc2SNiels Sascha Reedijk            </P>
222*1e36cfc2SNiels Sascha Reedijk         </TD>
223*1e36cfc2SNiels Sascha Reedijk      </TR>
224*1e36cfc2SNiels Sascha Reedijk   </TABLE>
225*1e36cfc2SNiels Sascha Reedijk
226*1e36cfc2SNiels Sascha Reedijk   <P>Returns an error. MIMEMultipartComponents don't have data of their own..</P>
227*1e36cfc2SNiels Sascha Reedijk
228*1e36cfc2SNiels Sascha Reedijk   <P><B>Return Value:</B></P>
229*1e36cfc2SNiels Sascha Reedijk
230*1e36cfc2SNiels Sascha Reedijk   <BLOCKQUOTE>- <B>B_BAD_TYPE</B> This operation is guranteed to fail.</BLOCKQUOTE></BLOCKQUOTE>
231*1e36cfc2SNiels Sascha Reedijk
232*1e36cfc2SNiels Sascha Reedijk<P>
233*1e36cfc2SNiels Sascha Reedijk
234*1e36cfc2SNiels Sascha Reedijk<HR>
235*1e36cfc2SNiels Sascha Reedijk
236*1e36cfc2SNiels Sascha Reedijk<A NAME=Instantiate></A><TABLE>
237*1e36cfc2SNiels Sascha Reedijk   <TR>
238*1e36cfc2SNiels Sascha Reedijk      <TD>
239*1e36cfc2SNiels Sascha Reedijk         <P></P>
240*1e36cfc2SNiels Sascha Reedijk      </TD>
241*1e36cfc2SNiels Sascha Reedijk      <TD>
242*1e36cfc2SNiels Sascha Reedijk         <P><FONT SIZE="+2">Instantiate () </FONT></P>
243*1e36cfc2SNiels Sascha Reedijk      </TD>
244*1e36cfc2SNiels Sascha Reedijk   </TR>
245*1e36cfc2SNiels Sascha Reedijk</TABLE>
246*1e36cfc2SNiels Sascha Reedijk</P>
247*1e36cfc2SNiels Sascha Reedijk
248*1e36cfc2SNiels Sascha Reedijk<P>&nbsp;</P>
249*1e36cfc2SNiels Sascha Reedijk
250*1e36cfc2SNiels Sascha Reedijk<BLOCKQUOTE><TABLE BORDER=2 BGCOLOR="#550033" WIDTH=1000>
251*1e36cfc2SNiels Sascha Reedijk      <TR>
252*1e36cfc2SNiels Sascha Reedijk         <TD>
253*1e36cfc2SNiels Sascha Reedijk            <P><TABLE BORDER=1 BGCOLOR="#FFFFFF" CELLPADDING=8 WIDTH=1000>
254*1e36cfc2SNiels Sascha Reedijk               <TR>
255*1e36cfc2SNiels Sascha Reedijk                  <TD>
256*1e36cfc2SNiels Sascha Reedijk                     <P>virtual status_t
257*1e36cfc2SNiels Sascha Reedijk                     <FONT SIZE="+1"><B><TT>Instantiate(</TT></B></FONT>BPositionIO
258*1e36cfc2SNiels Sascha Reedijk                     *<FONT FACE="HELVETICA" COLOR="#991122"><I>data</I></FONT>,
259*1e36cfc2SNiels Sascha Reedijk                     size_t <FONT FACE="HELVETICA" COLOR="#991122"><I>length</I></FONT><FONT SIZE="+1"><B><TT>)</TT></B></FONT></P>
260*1e36cfc2SNiels Sascha Reedijk                  </TD>
261*1e36cfc2SNiels Sascha Reedijk               </TR>
262*1e36cfc2SNiels Sascha Reedijk            </TABLE>
263*1e36cfc2SNiels Sascha Reedijk            </P>
264*1e36cfc2SNiels Sascha Reedijk         </TD>
265*1e36cfc2SNiels Sascha Reedijk      </TR>
266*1e36cfc2SNiels Sascha Reedijk   </TABLE>
267*1e36cfc2SNiels Sascha Reedijk
268*1e36cfc2SNiels Sascha Reedijk   <P>Does what you would expect. Creates a list of components from <FONT FACE="HELVETICA" COLOR="#991122"><I>data</I></FONT>. Note that you <B>cannot</B> delete <FONT FACE="HELVETICA" COLOR="#991122"><I>data</I></FONT>, as we cache
269*1e36cfc2SNiels Sascha Reedijk   it for later. This is because, as a memory and CPU saving measure, we do not actually instantiate these components until asked to. Thus instantiating an MIMEMultipartContainer is not a
270*1e36cfc2SNiels Sascha Reedijk   processor or memory-intensive operation.</BLOCKQUOTE>
271*1e36cfc2SNiels Sascha Reedijk
272*1e36cfc2SNiels Sascha Reedijk   <P><B>Return Value:</B></P>
273*1e36cfc2SNiels Sascha Reedijk
274*1e36cfc2SNiels Sascha Reedijk   <BLOCKQUOTE>- <B>B_OK</B> if everything succeeds.
275*1e36cfc2SNiels Sascha Reedijk
276*1e36cfc2SNiels Sascha Reedijk      <P>- <B>B_BAD_TYPE</B> if <FONT FACE="HELVETICA" COLOR="#991122"><I>data</I></FONT><FONT FACE="HELVETICA"></FONT> is not an MIME multipart component</P>
277*1e36cfc2SNiels Sascha Reedijk	</BLOCKQUOTE></BLOCKQUOTE>
278*1e36cfc2SNiels Sascha Reedijk
279*1e36cfc2SNiels Sascha Reedijk<P>
280*1e36cfc2SNiels Sascha Reedijk
281*1e36cfc2SNiels Sascha Reedijk<HR>
282*1e36cfc2SNiels Sascha Reedijk
283*1e36cfc2SNiels Sascha Reedijk<A NAME=Render></A><TABLE>
284*1e36cfc2SNiels Sascha Reedijk   <TR>
285*1e36cfc2SNiels Sascha Reedijk      <TD>
286*1e36cfc2SNiels Sascha Reedijk         <P></P>
287*1e36cfc2SNiels Sascha Reedijk      </TD>
288*1e36cfc2SNiels Sascha Reedijk      <TD>
289*1e36cfc2SNiels Sascha Reedijk         <P><FONT SIZE="+2">Render () </FONT></P>
290*1e36cfc2SNiels Sascha Reedijk      </TD>
291*1e36cfc2SNiels Sascha Reedijk   </TR>
292*1e36cfc2SNiels Sascha Reedijk</TABLE>
293*1e36cfc2SNiels Sascha Reedijk</P>
294*1e36cfc2SNiels Sascha Reedijk
295*1e36cfc2SNiels Sascha Reedijk<P>&nbsp;</P>
296*1e36cfc2SNiels Sascha Reedijk
297*1e36cfc2SNiels Sascha Reedijk<BLOCKQUOTE><TABLE BORDER=2 BGCOLOR="#550033" WIDTH=1000>
298*1e36cfc2SNiels Sascha Reedijk      <TR>
299*1e36cfc2SNiels Sascha Reedijk         <TD>
300*1e36cfc2SNiels Sascha Reedijk            <P><TABLE BORDER=1 BGCOLOR="#FFFFFF" CELLPADDING=8 WIDTH=1000>
301*1e36cfc2SNiels Sascha Reedijk               <TR>
302*1e36cfc2SNiels Sascha Reedijk                  <TD>
303*1e36cfc2SNiels Sascha Reedijk                     <P>virtual status_t
304*1e36cfc2SNiels Sascha Reedijk                     <FONT SIZE="+1"><B><TT>Render(</TT></B></FONT>BPositionIO
305*1e36cfc2SNiels Sascha Reedijk                     *<FONT FACE="HELVETICA" COLOR="#991122"><I>data</I></FONT><FONT SIZE="+1"><B><TT>)</TT></B></FONT></P>
306*1e36cfc2SNiels Sascha Reedijk                  </TD>
307*1e36cfc2SNiels Sascha Reedijk               </TR>
308*1e36cfc2SNiels Sascha Reedijk            </TABLE>
309*1e36cfc2SNiels Sascha Reedijk            </P>
310*1e36cfc2SNiels Sascha Reedijk         </TD>
311*1e36cfc2SNiels Sascha Reedijk      </TR>
312*1e36cfc2SNiels Sascha Reedijk   </TABLE>
313*1e36cfc2SNiels Sascha Reedijk
314*1e36cfc2SNiels Sascha Reedijk   <P>Renders the component into RFC 822 format and places the result
315*1e36cfc2SNiels Sascha Reedijk   in <FONT FACE="HELVETICA" COLOR="#991122"><I>data</I></FONT>,
316*1e36cfc2SNiels Sascha Reedijk   starting at <FONT FACE="HELVETICA" COLOR="#991122"><I>data
317*1e36cfc2SNiels Sascha Reedijk   </I></FONT>-&gt;Position().</P>
318*1e36cfc2SNiels Sascha Reedijk
319*1e36cfc2SNiels Sascha Reedijk   <P><B>Return Value:</B></P>
320*1e36cfc2SNiels Sascha Reedijk
321*1e36cfc2SNiels Sascha Reedijk   <BLOCKQUOTE>- <B>B_OK</B> if everything succeeds.
322*1e36cfc2SNiels Sascha Reedijk
323*1e36cfc2SNiels Sascha Reedijk      <P>- Something else in the event of failure.</P></BLOCKQUOTE></BLOCKQUOTE>
324*1e36cfc2SNiels Sascha Reedijk
325*1e36cfc2SNiels Sascha Reedijk<P>
326*1e36cfc2SNiels Sascha Reedijk
327*1e36cfc2SNiels Sascha Reedijk<HR>
328*1e36cfc2SNiels Sascha Reedijk
329*1e36cfc2SNiels Sascha Reedijk<A NAME=SetBoundary></A><TABLE>
330*1e36cfc2SNiels Sascha Reedijk   <TR>
331*1e36cfc2SNiels Sascha Reedijk      <TD>
332*1e36cfc2SNiels Sascha Reedijk         <P></P>
333*1e36cfc2SNiels Sascha Reedijk      </TD>
334*1e36cfc2SNiels Sascha Reedijk      <TD>
335*1e36cfc2SNiels Sascha Reedijk         <P><FONT SIZE="+2">SetBoundary() </FONT></P>
336*1e36cfc2SNiels Sascha Reedijk      </TD>
337*1e36cfc2SNiels Sascha Reedijk   </TR>
338*1e36cfc2SNiels Sascha Reedijk</TABLE>
339*1e36cfc2SNiels Sascha Reedijk</P>
340*1e36cfc2SNiels Sascha Reedijk
341*1e36cfc2SNiels Sascha Reedijk<P>&nbsp;</P>
342*1e36cfc2SNiels Sascha Reedijk
343*1e36cfc2SNiels Sascha Reedijk<BLOCKQUOTE><TABLE BORDER=2 BGCOLOR="#550033" WIDTH=1000>
344*1e36cfc2SNiels Sascha Reedijk      <TR>
345*1e36cfc2SNiels Sascha Reedijk         <TD>
346*1e36cfc2SNiels Sascha Reedijk            <P><TABLE BORDER=1 BGCOLOR="#FFFFFF" CELLPADDING=8 WIDTH=1000>
347*1e36cfc2SNiels Sascha Reedijk               <TR>
348*1e36cfc2SNiels Sascha Reedijk                  <TD>
349*1e36cfc2SNiels Sascha Reedijk                     <P>void
350*1e36cfc2SNiels Sascha Reedijk                     <FONT SIZE="+1"><B><TT>SetBoundary(</TT></B></FONT>
351*1e36cfc2SNiels Sascha Reedijk                     const char *<FONT FACE="HELVETICA" COLOR="#991122"><I>boundary</I></FONT>
352*1e36cfc2SNiels Sascha Reedijk                     <FONT SIZE="+1"><B><TT>)</TT></B></FONT></P>
353*1e36cfc2SNiels Sascha Reedijk                  </TD>
354*1e36cfc2SNiels Sascha Reedijk               </TR>
355*1e36cfc2SNiels Sascha Reedijk            </TABLE>
356*1e36cfc2SNiels Sascha Reedijk            </P>
357*1e36cfc2SNiels Sascha Reedijk         </TD>
358*1e36cfc2SNiels Sascha Reedijk      </TR>
359*1e36cfc2SNiels Sascha Reedijk   </TABLE>
360*1e36cfc2SNiels Sascha Reedijk
361*1e36cfc2SNiels Sascha Reedijk   <P>Sets the boundary between parts to <FONT FACE="HELVETICA" COLOR="#991122"><I>boundary</I></FONT>.
362*1e36cfc2SNiels Sascha Reedijk   Note that <FONT FACE="HELVETICA" COLOR="#991122"><I>boundary</I></FONT> can be an arbitrary text string but <B>must</B> contain only US-ASCII
363*1e36cfc2SNiels Sascha Reedijk   characters and be unique to this particular MIMEMultipartContainer. It does not have to be globally unique, however.</P></BLOCKQUOTE>
364*1e36cfc2SNiels Sascha Reedijk
365*1e36cfc2SNiels Sascha Reedijk<P>
366*1e36cfc2SNiels Sascha Reedijk
367*1e36cfc2SNiels Sascha Reedijk<HR>
368*1e36cfc2SNiels Sascha Reedijk
369*1e36cfc2SNiels Sascha Reedijk<A NAME=SetThisIsAnMIMEMessageText></A><TABLE>
370*1e36cfc2SNiels Sascha Reedijk   <TR>
371*1e36cfc2SNiels Sascha Reedijk      <TD>
372*1e36cfc2SNiels Sascha Reedijk         <P></P>
373*1e36cfc2SNiels Sascha Reedijk      </TD>
374*1e36cfc2SNiels Sascha Reedijk      <TD>
375*1e36cfc2SNiels Sascha Reedijk         <P><FONT SIZE="+2">SetThisIsAnMIMEMessageText() </FONT></P>
376*1e36cfc2SNiels Sascha Reedijk      </TD>
377*1e36cfc2SNiels Sascha Reedijk   </TR>
378*1e36cfc2SNiels Sascha Reedijk</TABLE>
379*1e36cfc2SNiels Sascha Reedijk</P>
380*1e36cfc2SNiels Sascha Reedijk
381*1e36cfc2SNiels Sascha Reedijk<P>&nbsp;</P>
382*1e36cfc2SNiels Sascha Reedijk
383*1e36cfc2SNiels Sascha Reedijk<BLOCKQUOTE><TABLE BORDER=2 BGCOLOR="#550033" WIDTH=1000>
384*1e36cfc2SNiels Sascha Reedijk      <TR>
385*1e36cfc2SNiels Sascha Reedijk         <TD>
386*1e36cfc2SNiels Sascha Reedijk            <P><TABLE BORDER=1 BGCOLOR="#FFFFFF" CELLPADDING=8 WIDTH=1000>
387*1e36cfc2SNiels Sascha Reedijk               <TR>
388*1e36cfc2SNiels Sascha Reedijk                  <TD>
389*1e36cfc2SNiels Sascha Reedijk                     <P>void
390*1e36cfc2SNiels Sascha Reedijk                     <FONT SIZE="+1"><B><TT>SetThisIsAnMIMEMessageText(</TT></B></FONT>
391*1e36cfc2SNiels Sascha Reedijk                     const char *<FONT FACE="HELVETICA" COLOR="#991122"><I>text</I></FONT>
392*1e36cfc2SNiels Sascha Reedijk                     <FONT SIZE="+1"><B><TT>)</TT></B></FONT></P>
393*1e36cfc2SNiels Sascha Reedijk                  </TD>
394*1e36cfc2SNiels Sascha Reedijk               </TR>
395*1e36cfc2SNiels Sascha Reedijk            </TABLE>
396*1e36cfc2SNiels Sascha Reedijk            </P>
397*1e36cfc2SNiels Sascha Reedijk         </TD>
398*1e36cfc2SNiels Sascha Reedijk      </TR>
399*1e36cfc2SNiels Sascha Reedijk   </TABLE>
400*1e36cfc2SNiels Sascha Reedijk
401*1e36cfc2SNiels Sascha Reedijk   <P>Sets the warning text about &quot;This is an MIME message...&quot; to <FONT FACE="HELVETICA" COLOR="#991122"><I>text</I></FONT>,
402*1e36cfc2SNiels Sascha Reedijk   which need not be specified at all. We reccomend that it only be set in the top-most <B>MIMEMultipartContainer</B> of the message.</P></BLOCKQUOTE>
403*1e36cfc2SNiels Sascha Reedijk
404*1e36cfc2SNiels Sascha Reedijk<P>
405*1e36cfc2SNiels Sascha Reedijk
406*1e36cfc2SNiels Sascha Reedijk<HR>
407*1e36cfc2SNiels Sascha Reedijk
408*1e36cfc2SNiels Sascha Reedijk<A NAME=AddComponent></A><TABLE>
409*1e36cfc2SNiels Sascha Reedijk   <TR>
410*1e36cfc2SNiels Sascha Reedijk      <TD>
411*1e36cfc2SNiels Sascha Reedijk         <P></P>
412*1e36cfc2SNiels Sascha Reedijk      </TD>
413*1e36cfc2SNiels Sascha Reedijk      <TD>
414*1e36cfc2SNiels Sascha Reedijk         <P><FONT SIZE="+2">AddComponent() </FONT></P>
415*1e36cfc2SNiels Sascha Reedijk      </TD>
416*1e36cfc2SNiels Sascha Reedijk   </TR>
417*1e36cfc2SNiels Sascha Reedijk</TABLE>
418*1e36cfc2SNiels Sascha Reedijk</P>
419*1e36cfc2SNiels Sascha Reedijk
420*1e36cfc2SNiels Sascha Reedijk<P>&nbsp;</P>
421*1e36cfc2SNiels Sascha Reedijk
422*1e36cfc2SNiels Sascha Reedijk<BLOCKQUOTE><TABLE BORDER=2 BGCOLOR="#550033" WIDTH=1000>
423*1e36cfc2SNiels Sascha Reedijk      <TR>
424*1e36cfc2SNiels Sascha Reedijk         <TD>
425*1e36cfc2SNiels Sascha Reedijk            <P><TABLE BORDER=1 BGCOLOR="#FFFFFF" CELLPADDING=8 WIDTH=1000>
426*1e36cfc2SNiels Sascha Reedijk               <TR>
427*1e36cfc2SNiels Sascha Reedijk                  <TD>
428*1e36cfc2SNiels Sascha Reedijk                     <P>
429*1e36cfc2SNiels Sascha Reedijk                     void <FONT SIZE="+1"><B><TT>AddComponent(</TT></B></FONT>
430*1e36cfc2SNiels Sascha Reedijk                     <A HREF="MailComponent.html">MailComponent</A> *<FONT FACE="HELVETICA" COLOR="#991122"><I>component</I></FONT>
431*1e36cfc2SNiels Sascha Reedijk                     <FONT SIZE="+1"><B><TT>)</TT></B></FONT></P>
432*1e36cfc2SNiels Sascha Reedijk                  </TD>
433*1e36cfc2SNiels Sascha Reedijk               </TR>
434*1e36cfc2SNiels Sascha Reedijk            </TABLE>
435*1e36cfc2SNiels Sascha Reedijk            </P>
436*1e36cfc2SNiels Sascha Reedijk         </TD>
437*1e36cfc2SNiels Sascha Reedijk      </TR>
438*1e36cfc2SNiels Sascha Reedijk   </TABLE>
439*1e36cfc2SNiels Sascha Reedijk
440*1e36cfc2SNiels Sascha Reedijk   <P>Adds <FONT FACE="HELVETICA" COLOR="#991122"><I>component</I></FONT> to this MIMEMultipartContainer. Note that the MIMEMultipartContainer
441*1e36cfc2SNiels Sascha Reedijk   assumes ownership of <FONT FACE="HELVETICA" COLOR="#991122"><I>component</I></FONT>. Thus, you <B>may not</B> delete <FONT FACE="HELVETICA" COLOR="#991122"><I>component</I></FONT>.
442*1e36cfc2SNiels Sascha Reedijk   If you continue to modify to it after calling <A HREF="#AddComponent">AddComponent()</A>, your changes will be reflected when you
443*1e36cfc2SNiels Sascha Reedijk   call <A HREF="#Render">Render()</A>.</P></BLOCKQUOTE>
444*1e36cfc2SNiels Sascha Reedijk
445*1e36cfc2SNiels Sascha Reedijk<P>
446*1e36cfc2SNiels Sascha Reedijk
447*1e36cfc2SNiels Sascha Reedijk<HR>
448*1e36cfc2SNiels Sascha Reedijk
449*1e36cfc2SNiels Sascha Reedijk<A NAME=GetComponent></A><TABLE>
450*1e36cfc2SNiels Sascha Reedijk   <TR>
451*1e36cfc2SNiels Sascha Reedijk      <TD>
452*1e36cfc2SNiels Sascha Reedijk         <P></P>
453*1e36cfc2SNiels Sascha Reedijk      </TD>
454*1e36cfc2SNiels Sascha Reedijk      <TD>
455*1e36cfc2SNiels Sascha Reedijk         <P><FONT SIZE="+2">GetComponent() </FONT></P>
456*1e36cfc2SNiels Sascha Reedijk      </TD>
457*1e36cfc2SNiels Sascha Reedijk   </TR>
458*1e36cfc2SNiels Sascha Reedijk</TABLE>
459*1e36cfc2SNiels Sascha Reedijk</P>
460*1e36cfc2SNiels Sascha Reedijk
461*1e36cfc2SNiels Sascha Reedijk<P>&nbsp;</P>
462*1e36cfc2SNiels Sascha Reedijk
463*1e36cfc2SNiels Sascha Reedijk<BLOCKQUOTE><TABLE BORDER=2 BGCOLOR="#550033" WIDTH=1000>
464*1e36cfc2SNiels Sascha Reedijk      <TR>
465*1e36cfc2SNiels Sascha Reedijk         <TD>
466*1e36cfc2SNiels Sascha Reedijk            <P><TABLE BORDER=1 BGCOLOR="#FFFFFF" CELLPADDING=8 WIDTH=1000>
467*1e36cfc2SNiels Sascha Reedijk               <TR>
468*1e36cfc2SNiels Sascha Reedijk                  <TD>
469*1e36cfc2SNiels Sascha Reedijk                     <P>
470*1e36cfc2SNiels Sascha Reedijk                     <A HREF="MailComponent.html">MailComponent</A> * <FONT SIZE="+1"><B><TT>GetComponent(</TT></B></FONT>
471*1e36cfc2SNiels Sascha Reedijk                     int32 <FONT FACE="HELVETICA" COLOR="#991122"><I>index</I></FONT>
472*1e36cfc2SNiels Sascha Reedijk                     <FONT SIZE="+1"><B><TT>)</TT></B></FONT></P>
473*1e36cfc2SNiels Sascha Reedijk                  </TD>
474*1e36cfc2SNiels Sascha Reedijk               </TR>
475*1e36cfc2SNiels Sascha Reedijk            </TABLE>
476*1e36cfc2SNiels Sascha Reedijk            </P>
477*1e36cfc2SNiels Sascha Reedijk         </TD>
478*1e36cfc2SNiels Sascha Reedijk      </TR>
479*1e36cfc2SNiels Sascha Reedijk   </TABLE>
480*1e36cfc2SNiels Sascha Reedijk
481*1e36cfc2SNiels Sascha Reedijk   <P>Returns the component at <FONT FACE="HELVETICA" COLOR="#991122"><I>index</I></FONT>.
482*1e36cfc2SNiels Sascha Reedijk   Instantiate()s it if it has not yet been instantiated. Otherwise, returns already instantiated
483*1e36cfc2SNiels Sascha Reedijk   component. Use RTTI or <A HREF="MailComponent.html">MailComponent</A> hooks to do useful things with the returned
484*1e36cfc2SNiels Sascha Reedijk   component.</P>
485*1e36cfc2SNiels Sascha Reedijk
486*1e36cfc2SNiels Sascha Reedijk   <P>&nbsp;</P>
487*1e36cfc2SNiels Sascha Reedijk
488*1e36cfc2SNiels Sascha Reedijk   <P></BLOCKQUOTE>
489*1e36cfc2SNiels Sascha Reedijk
490*1e36cfc2SNiels Sascha Reedijk<HR>
491*1e36cfc2SNiels Sascha Reedijk
492*1e36cfc2SNiels Sascha Reedijk<A NAME=CountComponents></A><TABLE>
493*1e36cfc2SNiels Sascha Reedijk   <TR>
494*1e36cfc2SNiels Sascha Reedijk      <TD>
495*1e36cfc2SNiels Sascha Reedijk         <P></P>
496*1e36cfc2SNiels Sascha Reedijk      </TD>
497*1e36cfc2SNiels Sascha Reedijk      <TD>
498*1e36cfc2SNiels Sascha Reedijk         <P><FONT SIZE="+2">CountComponents() </FONT></P>
499*1e36cfc2SNiels Sascha Reedijk      </TD>
500*1e36cfc2SNiels Sascha Reedijk   </TR>
501*1e36cfc2SNiels Sascha Reedijk</TABLE>
502*1e36cfc2SNiels Sascha Reedijk</P>
503*1e36cfc2SNiels Sascha Reedijk
504*1e36cfc2SNiels Sascha Reedijk<P>&nbsp;</P>
505*1e36cfc2SNiels Sascha Reedijk
506*1e36cfc2SNiels Sascha Reedijk<BLOCKQUOTE><TABLE BORDER=2 BGCOLOR="#550033" WIDTH=1000>
507*1e36cfc2SNiels Sascha Reedijk      <TR>
508*1e36cfc2SNiels Sascha Reedijk         <TD>
509*1e36cfc2SNiels Sascha Reedijk            <P><TABLE BORDER=1 BGCOLOR="#FFFFFF" CELLPADDING=8 WIDTH=1000>
510*1e36cfc2SNiels Sascha Reedijk               <TR>
511*1e36cfc2SNiels Sascha Reedijk                  <TD>
512*1e36cfc2SNiels Sascha Reedijk                     <P>
513*1e36cfc2SNiels Sascha Reedijk                     int32 <FONT SIZE="+1"><B><TT>CountComponents()</TT></B></FONT> const</P>
514*1e36cfc2SNiels Sascha Reedijk                  </TD>
515*1e36cfc2SNiels Sascha Reedijk               </TR>
516*1e36cfc2SNiels Sascha Reedijk            </TABLE>
517*1e36cfc2SNiels Sascha Reedijk            </P>
518*1e36cfc2SNiels Sascha Reedijk         </TD>
519*1e36cfc2SNiels Sascha Reedijk      </TR>
520*1e36cfc2SNiels Sascha Reedijk   </TABLE>
521*1e36cfc2SNiels Sascha Reedijk
522*1e36cfc2SNiels Sascha Reedijk   <P>Returns the total number of components in this MIMEMultipartContainer.</P>
523*1e36cfc2SNiels Sascha Reedijk
524*1e36cfc2SNiels Sascha Reedijk   <P>&nbsp;</P></BLOCKQUOTE>
525*1e36cfc2SNiels Sascha Reedijk
526*1e36cfc2SNiels Sascha Reedijk   <P>
527*1e36cfc2SNiels Sascha Reedijk
528*1e36cfc2SNiels Sascha Reedijk
529*1e36cfc2SNiels Sascha Reedijk<HR>
530*1e36cfc2SNiels Sascha Reedijk
531*1e36cfc2SNiels Sascha Reedijk<A NAME=ManualGetComponent></A><TABLE>
532*1e36cfc2SNiels Sascha Reedijk   <TR>
533*1e36cfc2SNiels Sascha Reedijk      <TD>
534*1e36cfc2SNiels Sascha Reedijk         <P></P>
535*1e36cfc2SNiels Sascha Reedijk      </TD>
536*1e36cfc2SNiels Sascha Reedijk      <TD>
537*1e36cfc2SNiels Sascha Reedijk         <P><FONT SIZE="+2">ManualGetComponent() </FONT></P>
538*1e36cfc2SNiels Sascha Reedijk      </TD>
539*1e36cfc2SNiels Sascha Reedijk   </TR>
540*1e36cfc2SNiels Sascha Reedijk</TABLE>
541*1e36cfc2SNiels Sascha Reedijk</P>
542*1e36cfc2SNiels Sascha Reedijk
543*1e36cfc2SNiels Sascha Reedijk<P>&nbsp;</P>
544*1e36cfc2SNiels Sascha Reedijk
545*1e36cfc2SNiels Sascha Reedijk<BLOCKQUOTE><TABLE BORDER=2 BGCOLOR="#550033" WIDTH=1000>
546*1e36cfc2SNiels Sascha Reedijk      <TR>
547*1e36cfc2SNiels Sascha Reedijk         <TD>
548*1e36cfc2SNiels Sascha Reedijk            <P><TABLE BORDER=1 BGCOLOR="#FFFFFF" CELLPADDING=8 WIDTH=1000>
549*1e36cfc2SNiels Sascha Reedijk               <TR>
550*1e36cfc2SNiels Sascha Reedijk                  <TD>
551*1e36cfc2SNiels Sascha Reedijk                     <P>
552*1e36cfc2SNiels Sascha Reedijk                     status_t <FONT SIZE="+1"><B><TT>ManualGetComponent(</TT></B></FONT>
553*1e36cfc2SNiels Sascha Reedijk                     <A HREF="MailComponent.html">MailComponent</A> * <FONT FACE="HELVETICA" COLOR="#991122"><I>component</I></FONT>,
554*1e36cfc2SNiels Sascha Reedijk                     int32 <FONT FACE="HELVETICA" COLOR="#991122"><I>index</I></FONT>
555*1e36cfc2SNiels Sascha Reedijk                     <FONT SIZE="+1"><B><TT>)</TT></B></FONT></P>
556*1e36cfc2SNiels Sascha Reedijk                  </TD>
557*1e36cfc2SNiels Sascha Reedijk               </TR>
558*1e36cfc2SNiels Sascha Reedijk            </TABLE>
559*1e36cfc2SNiels Sascha Reedijk            </P>
560*1e36cfc2SNiels Sascha Reedijk         </TD>
561*1e36cfc2SNiels Sascha Reedijk      </TR>
562*1e36cfc2SNiels Sascha Reedijk   </TABLE>
563*1e36cfc2SNiels Sascha Reedijk
564*1e36cfc2SNiels Sascha Reedijk   <P>Attempts to Instantiate() <FONT FACE="HELVETICA" COLOR="#991122"><I>component</I></FONT> from the component at
565*1e36cfc2SNiels Sascha Reedijk   <FONT FACE="HELVETICA" COLOR="#991122"><I>index</I></FONT>. Note that this will fail either if <FONT FACE="HELVETICA" COLOR="#991122"><I>component</I></FONT>->Instantiate() fails
566*1e36cfc2SNiels Sascha Reedijk   or if the component at <FONT FACE="HELVETICA" COLOR="#991122"><I>index</I></FONT> either does not exist or exists only as a <A HREF="MailComponent.html">MailComponent</A> and not as a raw buffer. In other words,
567*1e36cfc2SNiels Sascha Reedijk   this function will succeed if and only if the component at <FONT FACE="HELVETICA" COLOR="#991122"><I>index</I></FONT> exists, was part of the message
568*1e36cfc2SNiels Sascha Reedijk   when this MIMEMultipartContainer was instantiated and has not been written over since then, and <FONT FACE="HELVETICA" COLOR="#991122"><I>component</I></FONT>->Instantiate() succeeds on this buffer.
569*1e36cfc2SNiels Sascha Reedijk   <FONT FACE="HELVETICA" COLOR="#991122"><I>component</I></FONT> must be a valid <A HREF="MailComponent.html">MailComponent</A>.</P>
570*1e36cfc2SNiels Sascha Reedijk
571*1e36cfc2SNiels Sascha Reedijk   <P><B>Return Value:</B></P>
572*1e36cfc2SNiels Sascha Reedijk
573*1e36cfc2SNiels Sascha Reedijk   <BLOCKQUOTE>- <B>B_OK</B> if everything succeeds.
574*1e36cfc2SNiels Sascha Reedijk
575*1e36cfc2SNiels Sascha Reedijk      <P>- <B>B_BAD_INDEX</B> if <FONT FACE="HELVETICA" COLOR="#991122"><I>index</I></FONT> is out of range</P>
576*1e36cfc2SNiels Sascha Reedijk      <P>- <B>B_NAME_IN_USE</B> if the component at <FONT FACE="HELVETICA" COLOR="#991122"><I>index</I></FONT> does not exist in raw buffer form</P>
577*1e36cfc2SNiels Sascha Reedijk
578*1e36cfc2SNiels Sascha Reedijk      <P>- Something else if <FONT FACE="HELVETICA" COLOR="#991122"><I>component</I></FONT>->Instantiate() fails.</P>
579*1e36cfc2SNiels Sascha Reedijk	</BLOCKQUOTE>
580*1e36cfc2SNiels Sascha Reedijk
581*1e36cfc2SNiels Sascha Reedijk</BLOCKQUOTE>
582*1e36cfc2SNiels Sascha Reedijk<P>
583*1e36cfc2SNiels Sascha Reedijk
584*1e36cfc2SNiels Sascha Reedijk<HR>
585*1e36cfc2SNiels Sascha Reedijk
586*1e36cfc2SNiels Sascha Reedijk<A NAME=RemoveComponent></A><TABLE>
587*1e36cfc2SNiels Sascha Reedijk   <TR>
588*1e36cfc2SNiels Sascha Reedijk      <TD>
589*1e36cfc2SNiels Sascha Reedijk         <P></P>
590*1e36cfc2SNiels Sascha Reedijk      </TD>
591*1e36cfc2SNiels Sascha Reedijk      <TD>
592*1e36cfc2SNiels Sascha Reedijk         <P><FONT SIZE="+2">RemoveComponent() </FONT></P>
593*1e36cfc2SNiels Sascha Reedijk      </TD>
594*1e36cfc2SNiels Sascha Reedijk   </TR>
595*1e36cfc2SNiels Sascha Reedijk</TABLE>
596*1e36cfc2SNiels Sascha Reedijk</P>
597*1e36cfc2SNiels Sascha Reedijk
598*1e36cfc2SNiels Sascha Reedijk<P>&nbsp;</P>
599*1e36cfc2SNiels Sascha Reedijk
600*1e36cfc2SNiels Sascha Reedijk<BLOCKQUOTE><TABLE BORDER=2 BGCOLOR="#550033" WIDTH=1000>
601*1e36cfc2SNiels Sascha Reedijk      <TR>
602*1e36cfc2SNiels Sascha Reedijk         <TD>
603*1e36cfc2SNiels Sascha Reedijk            <P><TABLE BORDER=1 BGCOLOR="#FFFFFF" CELLPADDING=8 WIDTH=1000>
604*1e36cfc2SNiels Sascha Reedijk               <TR>
605*1e36cfc2SNiels Sascha Reedijk                  <TD>
606*1e36cfc2SNiels Sascha Reedijk                     <P>
607*1e36cfc2SNiels Sascha Reedijk                     status_t <FONT SIZE="+1"><B><TT>RemoveComponent(</TT></B></FONT>
608*1e36cfc2SNiels Sascha Reedijk                     int32 <FONT FACE="HELVETICA" COLOR="#991122"><I>index</I></FONT>
609*1e36cfc2SNiels Sascha Reedijk                     <FONT SIZE="+1"><B><TT>)</TT></B></FONT></P>
610*1e36cfc2SNiels Sascha Reedijk                  </TD>
611*1e36cfc2SNiels Sascha Reedijk               </TR>
612*1e36cfc2SNiels Sascha Reedijk            </TABLE>
613*1e36cfc2SNiels Sascha Reedijk            </P>
614*1e36cfc2SNiels Sascha Reedijk         </TD>
615*1e36cfc2SNiels Sascha Reedijk      </TR>
616*1e36cfc2SNiels Sascha Reedijk   </TABLE>
617*1e36cfc2SNiels Sascha Reedijk
618*1e36cfc2SNiels Sascha Reedijk   <P>Removes the component at <FONT FACE="HELVETICA" COLOR="#991122"><I>index</I></FONT> from the container and
619*1e36cfc2SNiels Sascha Reedijk   frees all memory associated with it (i.e. we delete it).</P>
620*1e36cfc2SNiels Sascha Reedijk
621*1e36cfc2SNiels Sascha Reedijk   <P><B>Return Value:</B></P>
622*1e36cfc2SNiels Sascha Reedijk
623*1e36cfc2SNiels Sascha Reedijk   <BLOCKQUOTE>- <B>B_OK</B> if everything succeeds.<P>
624*1e36cfc2SNiels Sascha Reedijk
625*1e36cfc2SNiels Sascha Reedijk      - <B>B_BAD_INDEX</B> if <FONT FACE="HELVETICA" COLOR="#991122"><I>index</I></FONT> is out of range</P>
626*1e36cfc2SNiels Sascha Reedijk	</BLOCKQUOTE>
627*1e36cfc2SNiels Sascha Reedijk
628*1e36cfc2SNiels Sascha Reedijk</BLOCKQUOTE>
629*1e36cfc2SNiels Sascha Reedijk
630*1e36cfc2SNiels Sascha Reedijk</TABLE></P>
631*1e36cfc2SNiels Sascha Reedijk
632*1e36cfc2SNiels Sascha Reedijk<P><!--TOP LINKS-->
633*1e36cfc2SNiels Sascha Reedijk
634*1e36cfc2SNiels Sascha Reedijk<HR NOSHADE>
635*1e36cfc2SNiels Sascha Reedijk
636*1e36cfc2SNiels Sascha Reedijk</P>
637*1e36cfc2SNiels Sascha Reedijk
638*1e36cfc2SNiels Sascha Reedijk<CENTER><TABLE BORDER=2 BGCOLOR="#FFDD88">
639*1e36cfc2SNiels Sascha Reedijk   <TR>
640*1e36cfc2SNiels Sascha Reedijk      <TD>
641*1e36cfc2SNiels Sascha Reedijk         <P><TABLE BGCOLOR="#550033" CELLPADDING=5>
642*1e36cfc2SNiels Sascha Reedijk            <TR>
643*1e36cfc2SNiels Sascha Reedijk               <TD>
644*1e36cfc2SNiels Sascha Reedijk                  <P><A HREF="../index.html"><FONT FACE="HELVETICA" COLOR="#FFFFFF"><B>Mail
645*1e36cfc2SNiels Sascha Reedijk                  Kit 2 Root</B></FONT></A></P>
646*1e36cfc2SNiels Sascha Reedijk               </TD>
647*1e36cfc2SNiels Sascha Reedijk               <TD>
648*1e36cfc2SNiels Sascha Reedijk                  <P><A HREF="index.html"><FONT FACE="HELVETICA" COLOR="#FFFFFF"><B>The
649*1e36cfc2SNiels Sascha Reedijk                  Public API</B></FONT></A></P>
650*1e36cfc2SNiels Sascha Reedijk               </TD>
651*1e36cfc2SNiels Sascha Reedijk            </TR>
652*1e36cfc2SNiels Sascha Reedijk         </TABLE>
653*1e36cfc2SNiels Sascha Reedijk         </P>
654*1e36cfc2SNiels Sascha Reedijk      </TD>
655*1e36cfc2SNiels Sascha Reedijk   </TR>
656*1e36cfc2SNiels Sascha Reedijk</TABLE>
657*1e36cfc2SNiels Sascha Reedijk</CENTER>
658*1e36cfc2SNiels Sascha Reedijk
659*1e36cfc2SNiels Sascha Reedijk<P><!--TOP LINKS--> <!-- Footer for Release 5 HTML Be Book --><BR>
660*1e36cfc2SNiels Sascha Reedijk</P>
661*1e36cfc2SNiels Sascha Reedijk
662*1e36cfc2SNiels Sascha Reedijk<CENTER><FONT SIZE="+3" COLOR="#555555"><I>Mail Daemon 2 API
663*1e36cfc2SNiels Sascha ReedijkDocumentation</I></FONT>
664*1e36cfc2SNiels Sascha Reedijk
665*1e36cfc2SNiels Sascha Reedijk<P><FONT SIZE="+1" COLOR="#555555"><I>&copy;2001 Dr. Zoidberg
666*1e36cfc2SNiels Sascha ReedijkEnterprises</I></FONT></P></CENTER>
667*1e36cfc2SNiels Sascha Reedijk</BODY>
668*1e36cfc2SNiels Sascha Reedijk</HTML>
669